云开发 Action，赋予 GitHub 云上超能力

云开发 Action 可以将 Github 项目自动部署到云开发环境，基于 CloudBase Framework，支持静态网站、云函数、云托管、小程序等项目。

现在，云开发 Action V2 版本已发布，更加简洁流畅，部署体验更棒，欢迎尝鲜！

https://github.com/TencentCloudBase/cloudbase-action

为何需要在意 GitHub Actions ?

GitHub Actions 是 GitHub 推出的一项解放双手、自动化开发流程的 CI/CD 服务。举个直观的例子，我们在浏览许多开源项目的时候，Git Commit 右边经常出现小红叉、小绿勾：

那么这个项目一定使用了 GitHub Actions (或其他 CI/CD 服务)。

这表明了很多项目对 GitHub Actions 的高度依赖，它在社区也是被高度认可的 👍。拿腾讯云开发来说，通过在项目中引入云开发 Action，即时便拥有了更优雅的自动化开发流程：

• 一体化：开发、代码审查、Issue、PR、构建、部署都不用离开 GitHub，使专注变为常态；
• 一键部署 › 自动部署：使用或了解过 CloudBase Framework 的用户都知道一键部署这个非常方便的服务，再加上云开发 Action，每次代码变更 (push pr star ...) 就可触发一键部署，不再需要人工干预；

• 对私密型数据更好的保护：密钥一经上传到 GitHub Secrets 之后，便不可能以任何形式明文查看该密钥，这比本地的 .env 安全得多 🔐

云开发 Action V2 有哪些升级？

探索 V2 版本时，尝试寻找一种解决方案，cloudbase-manager-node 是我的第一个尝试，这也是 V1 的解决方案，它也支持很多对其它云开发项目的管理。

幸运的是，cloudbase-framework 及时出现在我的脑中：它是云开发官方出品的前后端一体化部署工具，并配有丰富的插件；使用一个简单的配置文件，并结合 CloudBase CLI 工具，即可一键部署。

有了 cloudbase-framework ，我们就可以避免在 Action 中的二次开发，相反，用一套更加成熟的部署方案来替代

云开发 Action V2 诞生历程

此次 V2 的开发 GitHub Action 真的很简单，这都要感谢 cloudbase-framework 提供的一键部署能力。总结下来，把“大象”应用装进“冰箱”，云开发只要三部：

npm install -g @cloudbase/cli
tcb login --apiKeyId "$SECRET_ID" --apiKey "$SECRET_KEY"
tcb framework deploy -e "$ENV_ID"

安装 → 登录 → 部署，就是如此简单！

由于此过程不包含任何代码上的逻辑，所以我们并没有使用任何编程语言来实现这些过程；经过考量，我们选择了执行这些命令最快的地方 — SHELL ，用 GitHub 文档的术语来说，它是一个 composite run steps action ，核心的功能实现后，剩下的就是体验上的优化：

> 输出的简化：剔除部署时输出的无用信息，减少无用日志的输出

> 步骤分组：我们将三个关键的步骤分为三组，并追踪并高亮正在执行的命令，让用户更清楚当前的状态

> 文档优化：利用一个简单的云函数部署，手把手教你配置

快速上手 V2

枯燥的文字哪有代码有趣 ? 接下来的时间，我们来快速上手一下云开发 Action ：

本示例将演示：如何快速部署云函数到 CloudBase (同时设定部署的私密环境变量作为云函数 RUNTIME 的环境变量)

1、首先我们需要在项目中引入云开发 Action，编写如下的 Github Action 文件 .github/workflows/main.yml

on: [push]

jobs:
  deploy:
    runs-on: ubuntu-latest
    name: Tencent Cloudbase Github Action Example
    steps:
      - name: Checkout
        uses: actions/checkout@v2
      - name: Deploy to Tencent CloudBase
        uses: TencentCloudBase/cloudbase-action@v2
        with:
          secretId: ${{secrets.secretId}}
          secretKey: ${{secrets.secretKey}}
          envId: ${{secrets.envId}}

* 关于此配置文件的详细说明可点击文末阅读原文查看

假设我们在部署时需要设置私密型的环境变量(比如小程序 appid 或访问数据库的 accessToken)，请在以上代码中新增以下内容：

 name: Tencent Cloudbase Github Action Example
+env:
+  accessToken: ${{ secrets.accessToken }}

其中 env 下的 accessToken 键值对是我们部署时设置的环境变量，它的功能与本地的 .env 文件相同

2、为了使用云开发 Action V2 部署云函数，我们必须要在项目中配置 cloudbaserc.json 文件(并引入云函数插件和我们刚刚配置的环境变量)：

{
  "envId": "{{env.ENV_ID}}",
  "version": "2.0",
  "framework": {
    "name": "gh-actions-test",
    "plugins": {
      "func": {
        "use": "@cloudbase/framework-plugin-function",
        "inputs": {
          "functions": [
            {
              "name": "example",
              "memorySize": 128,
              "timeout": 5,
              "runtime": "Nodejs10.15",
              "handler": "index.main",
              "envVariables": {
                "accessToken": "{{env.accessToken}}"
              }
            }
          ]
        }
      }
    }
  }
}

* 关于此配置文件的详细说明可点击文末阅读原文查看

3、在项目 Settings/Secrets 里设置 secretId, secretKey, envId, accessToken 信息

4、配置完成后，提交代码到 Github 时，云开发 Action V2 就会自动部署项目中的 example 函数到云开发中，即时函数的环境变量也会设置成功。

欢迎贡献

相信你看完此篇文章，对 V2 能有更清晰的认识，也更有信心来参与到本项目中来。本项目遵循 All Contributors 规范，任何形式的贡献都会被加入贡献者名单，欢迎你的贡献 💗

https://github.com/TencentCloudBase/cloudbase-action

CloudBase Framework 开源项目介绍

🚀 CloudBase Framework 是云开发开源的云原生前后端一体化部署工具，支持主流前后端框架，前后端一键托管部署在云端一体化平台，支持支持小程序、Web、Flutter、后端服务等多个平台。

Github 开源地址：

https://github.com/Tencent/cloudbase-framework

欢迎给 CloudBase Framework 一个 🌟 star

CloudBase Framework 核心贡献者计划

欢迎大家参与 CloudBase Framework 的开发工作，成为我们的贡献者，我们将会在云开发社区展示贡献者的作品和信息，同时也会有惊喜奖励。

作者：@beetcb

https://github.com/beetcb

- End -

延伸阅读丨点击文章标题即可阅读

▷ 国内首发，这款 Serverless 云原生一体化部署工具正式开源

▷ CloudBase Framework 支持一键部署小程序

···